home *** CD-ROM | disk | FTP | other *** search
/ Freelog 46 / Freelog046.iso / Alu / Celestia / Win32HiresTex / celestia-win32-1.3.0.exe / {app} / README.txt < prev    next >
Text File  |  2003-02-21  |  16KB  |  410 lines

  1. Celestia:  A real-time visual space simulation
  2.  
  3. Copyright (C) 2001-2002, Chris Laurel <claurel@shatters.net>
  4.  
  5. --
  6.  
  7. This program is free software; you can redistribute it and/or
  8. modify it under the terms of the GNU General Public License
  9. as published by the Free Software Foundation; either version 2
  10. of the License, or (at your option) any later version.
  11.  
  12. This program is distributed in the hope that it will be useful,
  13. but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15. GNU General Public License for more details.
  16.  
  17. You should have received a copy of the GNU General Public License
  18. along with this program; if not, write to the Free Software
  19. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
  20. USA.
  21.  
  22. --
  23.  
  24. Installing:
  25.  
  26. WINDOWS:
  27. Unzip the files into a temporary directory, such as c:\temp\  Then, select
  28. Run from the Start menu and enter:
  29.  
  30. TEMPDIR\setup.exe
  31.  
  32. Where TEMPDIR is the name of your temporary directory (e.g. c:\temp\setup.exe)
  33. This will launch the setup program that will install Celestia on your
  34. computer.  After setup is complete, launch Celestia by selecting it from
  35. the start menu.
  36.  
  37. UNIX:
  38.  
  39. Type ./configure --help for a list of options.
  40.  
  41. The most basic commands are
  42.  
  43.     ./configure
  44.     make
  45.     make install
  46.  
  47. This will build the GTK version.
  48.  
  49. The new KDE3 version is built with
  50.  
  51.         ./configure --with-kde 
  52.         make 
  53.         make install 
  54.  
  55. Running Celestia:
  56.  
  57. Celestia will start up in a window, and if everything is working
  58. correctly, you'll see Jupiter's moon Io in front of a field of
  59. stars.  In the left corner is a welcome message and some information
  60. about your target (Io), your speed, and the current time (Universal
  61. Time, so it'll probably be a few hours off from your computer's clock.)
  62. Right drag the mouse to orbit Io and you should see Jupiter and
  63. some familiar constellations.  Left dragging the mouse changes your
  64. orientation too, but the camera rotates about its center instead of
  65. rotating around Io.  Rolling the mouse wheel will change your distance
  66. to the space station--you can move light years away, then roll the wheel
  67. in the opposite direction to get back to your starting location.  If your
  68. mouse lacks a wheel, you can use the Home and End keys instead.
  69.  
  70. In Celestia, you'll usually have some object selected; currently,
  71. it's Io, but it could also be a star, planet, spacecraft, or galaxy.
  72. The simplest way to select an object is to click on it.  Try clicking
  73. on a star to select it.  The information about Io is replaced with
  74. some details about the star.  Press G (or use the navigation menu),
  75. and you'll zoom through space toward the selected star.  If you
  76. press G again, you'll approach the star even closer.
  77.  
  78. Press H to select our Sun, and then G to go back to our solar system.
  79. You'll find yourself half a light year away from the sun, which looks
  80. merely like a bright star at this range.  Press G three more times to
  81. get within about 30 AU of the sun and you will be to see a few become
  82. visible near the sun.  Right click on the sun to bring up a menu of
  83. planets and other objects in the solar system.  After selecting a planet
  84. from the menu, hit G again to travel toward it.  Once there, hold down
  85. the right mouse button and drag to orbit the planet.
  86.  
  87. Tour Guide
  88. The tour guide is a list of some of the more interesting objects you can visit
  89. Celestia.  Select the Tour guide option in the navigation menu to bring up the
  90. guide window, choose a destination from the list, click the Goto button, and
  91. you're off.
  92.  
  93. That covers the very basics . . .
  94.  
  95. Mouse and Keyboard Controls for Celestia
  96. ----------------------------------------
  97.  
  98. Mouse Functions:
  99.  
  100. Left drag:           orient camera
  101. Right drag:          orbit the selected object
  102. Wheel:               adjust distance to selection
  103. Right + Left drag:   adjust distance to selection
  104. Ctrl  + Left drag:   adjust distance to selection
  105. Shift + Left drag:   change field of view (e.g. => telescopic view)
  106. Wheel (middle button) click:  toggle field of view between 45 degrees 
  107.                               and the previous field (e.g. telescopic view)
  108. Left - click:        select object 
  109. Left double click:   center selection
  110. Right - click:       bring up context menu
  111.  
  112. Keyboard Commands:
  113.  
  114. Navigation:
  115. H    : Select the sun (Home)
  116. C    : Center on selected object
  117. G    : Goto selected object
  118. F    : Follow selected object
  119. Y    : Orbit the selected object at a rate synced to its rotation
  120. :    : Lock on selected object
  121. "    : Chase selected object (orientation is based on selection's velocity)
  122. T    : Track selected object (keep selected object centered in view)
  123. HOME : Move closer to object
  124. *    : Look back
  125. END  : Move farther from object
  126. ESC  : Cancel motion or script
  127. Left/Right Arrows : Roll Camera
  128. Up / Down Arrows  : Change Camera Pitch
  129. 1-9  : Select planets around nearby sun
  130.  
  131. Time:
  132. Space : stop time
  133. L     : Time 10x faster
  134. K     : Time 10x slower
  135. J     : Reverse time
  136. !     : Set time to now
  137. ?     : Display light-travel delay between observer and selected object
  138. -     : Subtract light-travel delay from current simulation time
  139.  
  140. Labels:
  141. =  : Toggle constellation labels
  142. B  : Toggle star labels
  143. E  : Toggle galaxy labels
  144. M  : Toggle moon labels
  145. W  : Toggle asteroid & comet labels
  146. N  : Toggle spacecraft labels
  147. P  : Toggle planet labels
  148.  
  149. V  : Toggle verbosity of info text
  150.  
  151. Options:
  152. I  : Toggle cloud textures
  153. U  : Toggle galaxy rendering
  154. O  : Toggle planet orbits
  155. /  : Toggle constellation diagrams
  156. ;  : Show an earth-based equatorial coordinate sphere
  157. [  : If autoMag OFF: Decrease limiting magnitude (fewer stars visible)
  158.      If autoMag ON : Decrease limiting magnitude at 45 deg field of view 
  159. ]  : If autoMag OFF: Increase limiting magnitude (more stars visible)
  160.      If autoMag ON : Increase limiting magnitude at 45 deg field of view 
  161. {  : Decrease ambient illumination
  162. }  : Increase ambient illumination
  163. ,  : Narrow field of view
  164. .  : Widen field of view
  165. Backspace: Cancel current selection
  166. Ctrl+A : Toggle atmospheres
  167. Ctrl+B : Toggle constellation boundaries 
  168. Ctrl+E : Toggle eclipse shadow rendering
  169. Ctrl+L : Toggle night side planet maps (light pollution)
  170. Ctrl+S : Toggle rendering stars as points (otherwise, they're textures)
  171. Ctrl+P : Toggle per-pixel lighting (if supported)
  172. Ctrl+T : Toggle rendering of comet tails
  173. Ctrl+V : Toggle vertex programs (if supported)
  174. Ctrl+W : Toggle wireframe mode
  175. Ctrl+X : Toggle antialias lines
  176. Ctrl+Y : Toggle autoMag = auto adaptation of star visibility to field
  177.          of view   
  178. r R: lower or raise texture resolution
  179.  
  180. Multiview:
  181. Ctrl+R : Split view vertically
  182. Ctrl+U : Split view horizontally
  183. TAB    : Cycle active view
  184. DEL    : Delete active view
  185. Ctrl+D : Delete all views except active one
  186.  
  187. Spaceflight:
  188. F1 : Stop 
  189. F2 : Set velocity to 1 km/s
  190. F3 : Set velocity to 1,000 km/s
  191. F4 : Set velocity to speed of light
  192. F5 : Set velocity to 10x the speed of light.
  193. F6 : Set velocity to 1 AU/s
  194. F7 : Set velocity to 1 ly/s
  195. A  : Increase velocity
  196. Z  : Decrease velocity
  197. Q  : Reverse direction
  198. X  : Set movement direction toward center of screen
  199.  
  200. Number pad:
  201. 4  : Yaw left
  202. 6  : Yaw right
  203. 8  : Pitch down
  204. 2  : Pitch up
  205. 7  : Roll left
  206. 9  : Roll right
  207. 5  : Stop rotation
  208.  
  209. Joystick:
  210. X axis : yaw
  211. Y axis : pitch
  212. L trigger : roll left
  213. R trigger : roll right
  214. Button 1 : slower
  215. Button 2 : faster
  216.  
  217. Other:
  218. D   : Run demo
  219. F8  : Enable joystick
  220. F10 : Capture image to file
  221. `   : Show frames rendered per second
  222. ENTER : Select a star or planet by typing its name
  223. Ctrl+INS : Copy location URL to clipboard (Windows)
  224.  
  225.  
  226. Star and Planet Browsers:
  227. [For the moment This only applies to the Windows version of Celestia.]
  228. In the navigation menu are 'Solar System Browser' and 'Star Browser'
  229. options.  The Solar System Browser pops up a window with a tree view
  230. of all the objects in the nearest solar system (if there is one at all
  231. within a light year of your current position.)  Clicking on the name
  232. of any planet in the window will select it; you can then use the center
  233. or goto buttons to see it in the main Celestia window.  The star
  234. browser is a window showing a table of the hundred nearest stars,
  235. along with their distances and apparent and absolute magnitudes. 
  236. Clicking on the column headers will sort the stars.  The table is
  237. not continuously updated--if you travel to another star, you should
  238. press the Refresh button to update the table for your current position.
  239. The radio buttons beneath the table let you switch between viewing
  240. a list of nearest or brightest stars.  As with the solar system browser,
  241. clicking on any star name in the table will select it--use this feature
  242. along with the center button to tour the stars visible from any night
  243. sky in the galaxy.
  244.  
  245. Selecting Objects by Name:
  246. It's possible to choose a star or planet by name.  There are two ways to
  247. enter a star name: choose 'Select Object' from the Navigation menu to
  248. bring up a dialog box, or by hitting Enter, typing in the name, and
  249. pressing Enter again.  You can use common names, or Bayer designations
  250. and HD catalog numbers for stars.  Bayer and Flamsteed designations need
  251. to be entered like this:
  252.       Upsilon And
  253.       51 Peg 
  254. The constellation must be given as a three letter abbreviation and the
  255. full Greek letter name spelled out.  Irritating, but it'll be fixed.
  256. HD catalog numbers must be entered with a space between HD and the number.
  257.  
  258. Celestia handles star catalog numbers in a slightly kludgy way.  To keep the
  259. star database size to minimum, only one catalog number is stored.  Normally,
  260. this will a number from the HD catalog, but if a star isn't in the HD catalog
  261. the number from another catalog will be used instead.  Currently, the secondary
  262. catalog is always the HIPPARCOS data set, for which the prefix "HIP" should be
  263. used.
  264.  
  265.  
  266. Known Issues:
  267.  
  268. Many people have reported problems running Celestia with Matrox G400/G450
  269. 3D accelerator cards.  As I don't have a Matrox card, I haven't made much
  270. progress on this bug.  If you do have a G400, have Visual C++ installed, and
  271. would be interested in testing a debug version of Celestia, please contact me.
  272.  
  273. The maximum texture size supported by the Voodoo 1/2/3 is 256x256, so many
  274. of the planet textures will look blurry when running Celestia on one of these
  275. cards.
  276.  
  277. On 3D accelerator cards with a limited amount of memory, resizing the main
  278. Celestia window can cause textures to disappear.  This occurs because so
  279. much memory is required the frame buffer that there's not enough left for
  280. textures.  There are a several workarounds:
  281.     - Use a smaller window
  282.     - Make sure your display is set to 16-bit (high color) mode
  283.     - Try running Celestia in full screen mode
  284.  
  285. Celestia only barely works in 256 color mode; if your display is set to
  286. 256 colors, change to 16-bit or 32-bit if at all possible.
  287.  
  288. If look good at a distance but get to dark when you approach them closely,
  289. your OpenGL driver does not support a required extension.  Try upgrading to
  290. the most current version of drivers available for your card.  For some older
  291. cards, this still won't fix the problem.  The next version of Celestia will
  292. feature a workaround.
  293.  
  294.  
  295. Basic Hacking Tips:
  296.  
  297. It's possible to modify the solarsys.ssc, stars.dat, and hdnames.dat
  298. files to create an entirely fictional universe.
  299.  
  300. The easiest file to modify is the solar system catalog, as it's a text
  301. file and the format is very text-editor friendly since that's how I
  302. had to enter all the data.  It's also quite verbose, but that's not a
  303. problem yet.
  304.  
  305. The units used for the solar system data may not be obvious.  All
  306. angle fields in the catalog are in degrees.  For planets, the period
  307. is specified in earth years, and the semi-major axis in AU; for
  308. satellites, days and kilometers are used instead.
  309.  
  310. All solar system textures should be placed in the textures
  311. subdirectory.  Currently, JPEG and BMP are the only formats supported.
  312. Models belong in the models directory.  Celestia can read 3DS models,
  313. as well as a custom format (.cms files, used right now just for rough
  314. fractal displacement map likenesses of asteroids and small moons.)  3DS
  315. meshes are normalized to fit within a unit cube--the Radius field
  316. determines how big they appear within Celestia.
  317.  
  318. The stars.dat file is a binary database of stars, processed from
  319. the 50+ meg HIPPARCOS data set.  The first four bytes are an int
  320. containing the number of stars in the database.  Following that
  321. are a bunch of records of this form:
  322.  
  323. 4 byte int   : catalog number
  324. 4 byte float : right ascension
  325. 4 byte float : declination
  326. 4 byte float : parallax
  327. 2 byte int   : apparent magnitude
  328. 2 byte int   : stellar class
  329. 1 byte       : parallax error
  330.  
  331. RA, declination, and parallax are converted to x, y, z coordinates
  332. and apparent magnitude is converted to absolute magnitude when the
  333. database is read.
  334.  
  335.  
  336. Authors:
  337.  
  338. Chris Laurel
  339. Clint Weisbrod
  340. Fridger Schrempp
  341. Christophe Teyssier
  342. Deon Ramsey (UNIX installer, Gtk interface)
  343. Bob Ippolito (Mac OS X version)
  344. Christopher ANDRE (Eclipse finder)
  345. Colin Walters (endianness fixes)
  346. James Holmes
  347.  
  348.  
  349. Contributors:
  350.  
  351. Models of Mars Global Surveyor and Mars Odyssey were created by
  352. Shrox: http://www.shrox.com/
  353.  
  354. Most of the planet maps are from David Seal's
  355. site: http://maps.jpl.nasa.gov/.  A few of these maps were modified by me,
  356. with fictional terrain added to fill in gaps.  The model of the Galileo
  357. spacecraft is also from David Seal's site (though it was converter from
  358. Inventor to 3DS format.)
  359.  
  360. The Mars, Moon, and Pluto textures and bump maps are all from
  361. James Hastings-Trew's collection.  Some of the prettiest planet maps
  362. around are at http://apollo.spaceports.com/~jhasting/
  363.  
  364. The Venus, Saturn, and Saturn's rings textures are from Bjorn Jonsson.
  365. His site is http://www.mmedia.is/~bjj/ and is an excellent resource
  366. for solar system rendering.
  367.  
  368. The Earth texture was created by NASA using data from the MODIS instrument
  369. aboard the Terra satellite.  Further information is available from
  370. http://earthobservatory.nasa.gov/Newsroom/BlueMarble/
  371.  
  372. The textures for the Uranian satellites were created by Ivan Rivera from
  373. JPL data.  His Celestia page is http://bruckner.homelinux.net/celestia.html
  374.  
  375. The asteroid.jpg texture was created by Paul Roberts.
  376.  
  377. The lower resolution textures were all converted from their higher resolution
  378. Versions using Gimp.
  379.  
  380. 3D asteroid models of Toutatis, Kleopatra, and Geographos are courtesy of
  381. Scott Hudson, Washington State University.  His site is:
  382. http://www.eecs.wsu.edu/~hudson/Research/Asteroids/4179/index.html
  383.  
  384. 3D models of Phobos, Deimos, Amalthea, Proteus, Vesta, Ida,
  385. Mathilde, and Gaspra are derived from Phil Stooke's Cartography of
  386. Non-Spherical Worlds:  http://publish.uwo.ca/~pjstooke/plancart.htm
  387.  
  388. Grant Hutchinson supplied the correct orientations for the major planets
  389. and their moons.
  390.  
  391. The Mac OS X icon was designed by Chris Alford (http://www.chrisalford.com/)
  392.  
  393. The txf font format used by Celestia was devised by Mark Kilgard.
  394.  
  395. The star database (stars.dat) was derived from the ESA's HIPPARCOS data set.
  396.  
  397. This software is based in part on the work of the Independent JPEG
  398. Group.
  399.  
  400. Thank you to all the Celestia users who've submitted bug reports,
  401. suggestions, and fixes over the past year.  Celestia wouldn't be the
  402. program it is without your help.
  403.  
  404.  
  405. Chris Laurel
  406. claurel@shatters.net
  407. http://www.shatters.net/~claurel
  408. and
  409. http://www.shatters.net/celestia/
  410.